|
|
PBMakeFSSpecAsync |
||||
| Header: | Files.h | Carbon status: | Supported | |
Creates an FSSpec structure for a file or directory.
OSErr PBMakeFSSpecAsync (
HParmBlkPtr paramBlock
);
A pointer to a basic HFS parameter block.
A result code. If the specified volume is mounted and the specified parent directory exists, but the target file or directory doesn’t exist in that location, PBMakeFSSpecAsync fills in the structure and returns fnfErr instead of noErr. The structure is valid, but it describes a target that doesn’t exist. You can use the structure for another operation, such as creating a file.
PBMakeFSSpecAsync can return a number of different File Manager error codes. When PBMakeFSSpecAsync returns any result other than noErr or fnfErr, all fields of the resulting FSSpec structure are set to 0.
The relevant fields of the parameter block are:
On input, a pointer to a completion routine.
On output, the result code of the function.
On input, a pointer to a file or directory name.
On input, a volume specification.
On input, a pointer to an FSSpec structure.
On input, a parent directory ID.
Given a complete specification for a file or directory, the PBMakeFSSpecAsync function fills in an FSSpec structure that identifies the file or directory.
Supported in Carbon. Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.
© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)